home *** CD-ROM | disk | FTP | other *** search
/ Freelog Special Freeware 28 / FreelogHS28.iso / Outils / Albumart / albumart-1.6.0-setup.exe / {app} / Readme.txt < prev   
Text File  |  2005-06-07  |  3KB  |  91 lines
  1.                           Album Cover Art Downloader
  2.                   http://kempele.fi/~skyostil/projects/albumart
  3.  
  4.    Here's a program that will semi-automatically download album
  5.    cover images for your music collection. All you have to do
  6.    is point it at the root of your music directory and for each
  7.    directory, the program will download a set of corresponding
  8.    (well, best guess) album covers from the Internet, from
  9.    which you can choose one that suits your fancy.
  10.  
  11.    Currently supported image providers:
  12.  
  13.      * Amazon.com
  14.      * Yahoo! Images
  15.      * Wal-Mart
  16.      * Buy.com
  17.  
  18.    At least the following programs make use of the cover
  19.    images:
  20.  
  21.      * KDE, GNOME and others that follow the FreeDesktop.org
  22.        .desktop-entry spec
  23.      * Windows XP Explorer
  24.      * Windows Media Player 9+
  25.      * CDcover, an XMMS plugin
  26.      * CoverViewer, another XMMS plugin.
  27.      * wmalbum, a WindowMaker dock applet
  28.      * Various WinAMP plugins, for example ShowCover.
  29.  
  30.    In addition, some portable music players can show the cover
  31.    image if it is embedded in the MP3 file.
  32.  
  33.  Usage
  34.  
  35.    Click File | Open and navigate to the directory containing
  36.    the albums you want to find cover images for. The program
  37.    will load all the music files under the path you chose and
  38.    sort them into albums.
  39.  
  40.    If you are feeling lazy, just select Edit | Select All
  41.    followed by Edit | Download missing cover images and sit
  42.    back while the program downloads covers for all the
  43.    directories lacking them. The automatic downloader only
  44.    accepts exact matches while searching covers, so it may miss
  45.    some directories.
  46.  
  47.    To set a cover manually, pick a directory from the list and
  48.    check that the artist and album fields at the top-right
  49.    corner are sensible. Now click Download Covers. After a few
  50.    seconds you should see a list of cover images on the right.
  51.    If no images are found, try to simplify the artist and album
  52.    fields (e.g. clear the album field completely). You can also
  53.    drop an image from your file manager on the list to use that
  54.    one.
  55.  
  56.    Go ahead and choose a suitable cover from the list. Finally,
  57.    click Set as Cover to confirm your choice. You can also drag
  58.    and drop the cover image on the albums or music files of your 
  59.    choice.
  60.  
  61.  Command line options
  62.  
  63.    -h, --help
  64.           Show summary of options.
  65.  
  66.    -d, --download
  67.           Download covers for the given path.
  68.  
  69.    -x, --delete
  70.           Remove covers below the given path.
  71.  
  72.    -s, --synchronize
  73.           Synchronizes all covers below the given path.
  74.  
  75.    -H, --hidden
  76.           Don't show a progress dialog while working.
  77.  
  78.    -i, --summary
  79.           Show summary information when done.
  80.  
  81.  Internals
  82.  
  83.    The cover images are in one or more of the following places:
  84.  
  85.      * folder.jpg for Windows XP
  86.      * .folder.png and an Icon entry in .directory for
  87.        Konqueror, etc.
  88.      * ID3v2 APIC frame, which is embedded into the MP3 files.
  89.      * Additional custom image targets are supported
  90.  
  91.